home *** CD-ROM | disk | FTP | other *** search
/ Gekikoh Dennoh Club 2 / Gekikoh Dennoh Club Vol. 2 (Japan).7z / Gekikoh Dennoh Club Vol. 2 (Japan) (Track 01).bin / fsw / mcdrv / mctech.doc < prev    next >
Text File  |  1996-05-01  |  13KB  |  493 lines
  1.  
  2.     ───────────────────────────────
  3.  
  4.                   ＭＣＤＲＶ
  5.  
  6.                Music Creative driver for X680x0
  7.  
  8.            【外部からの操作の仕方や情報の取得方法等の解説】
  9.  
  10.     ───────────────────────────────
  11.  
  12.                     written by CUL. (1996-04-04)
  13.  
  14.  
  15.   このドキュメントでは以下の項目についての解説してあります。
  16.  
  17.     ・システム/トラックワーク参照
  18.     ・ノートオン/オフ情報取得
  19.     ・演奏同期
  20.     ・メモリ管理テーブルの構造
  21.     ・効果音等について
  22.  
  23.  
  24. ───────────────────────────────────────
  25.             システム/トラックワーク参照
  26. ───────────────────────────────────────
  27.  
  28.   MCDRV では、トラックワークとシステムワークの一部の参照を禁止しています。これ
  29. は、バージョン間の互換性を考えたもので、支援ソフトの開発を妨げるものではありま
  30. せん。
  31.  
  32.   システムワークは仕様が固まり次第順次公開していく予定です。
  33.  
  34.   トラックワークを順次操作して行くプログラムなどは、サービスコール
  35.  
  36.     $1f    _GETTRWORKSIZE    トラックワークサイズの取得
  37.  
  38. で１トラックワークの長さを求めて、処理をするようにして下さい。
  39.  
  40.   これらの事項を守ったプログラムならば、MCDRV v0.40～v0.99 まで互換がとれるこ
  41. とを保証します。
  42.  
  43.  
  44.   以下は公開されているワークの説明です。
  45.  
  46.   (一部に間違いがあるかもしれないので注意して下さい)
  47.  
  48.  
  49. ■ ワーク全体の構造
  50.  
  51.   ワークの構造は _GETWORKADR で求めたアドレスから正と負の両方へ延びるような形
  52. になっています。
  53.  
  54.     ：        ：
  55.     │ SYSTEM WORK    │  負    ↑システムワーク
  56.     │        │
  57.     ┝━━━━━━━┥±０ ← _GETWORKADR で返されるアドレス
  58.     │  TRACK #01    │
  59.     ├───────┤  正    ↓トラックワーク
  60.     │  TRACK #02    │
  61.     ├───────┤
  62.     ：        ：
  63.  
  64.   以下は各ワークの説明です。切り取ってそのままインクルードする事ができます。
  65.  
  66.  
  67. *    ■ システムワーク
  68.  
  69. INF_MIDIINBUF:    equ    -$a0    *8.l MIDI IN バッファへのポインタ (解説は後述)
  70.  
  71. INF_PLAY:    equ    -$80    *.w ポーズフラグ    0:STOP  1:PAUSE 2:PLAY
  72.  
  73. INF_FADES:    equ    -$7e    *.w フェードフラグ(sys)    0:NOMAL 1:F.IN  2:F.OUT
  74.  
  75. INF_FADEM:    equ    -$7c    *.w フェードフラグ(曲)    0:NOMAL 1:F.IN  2:F.OUT
  76.  
  77. INF_KSFTS:    equ    -$7a    *.w キーシフト(sys)    (-127～127)
  78.  
  79. INF_KSFTM:    equ    -$78    *.w キーシフト(曲)        〃
  80.  
  81. INF_KSFT:    equ    -$76    *.w キーシフト(合計)        〃
  82.  
  83. INF_TRNUM:    equ    -$70    *.w トラック数        (32～128)
  84.  
  85. INF_TRUSE:    equ    -$6e    *.w 使用トラック数    (0～128)
  86.  
  87. INF_LOOP:    equ    -$6c    *.w ループカウンター
  88.  
  89. INF_TEMPOSNS:    equ    -$6a    *.w テンポセンス    (1～4096)
  90.  
  91. INF_DIVISION:    equ    -$68    *.w ４分音符の分解能
  92.  
  93. INF_TEMPO:    equ    -$66    *.w テンポ        (1～4096)
  94.  
  95. INF_ENDCLOCK:    equ    -$64    *.l 演奏終了時のクロック
  96.  
  97. INF_NOWCLOCK:    equ    -$60    *.l 現在の経過クロック
  98.  
  99. INF_INTERVAL:    equ    -$5c    *.l 割り込み間隔 (1/10^6秒単位)
  100.  
  101. INF_PASSC:    equ    -$58    *.l 1/10^6秒カウンタ    (0～999999)
  102.  
  103. INF_PASSMIN:    equ    -$54    *.w 経過時間(分)    (0～65535)
  104.  
  105. INF_PASSSEC:    equ    -$52    *.w 経過時間(秒)    (0～59)
  106.  
  107. INF_TRACT:    equ    -$40    *8.l トラックアクト    0:SLEEP 1:ACTIVE
  108.  
  109. *    トラックの動作状態です。ビットマップで格納されており、格納方式は
  110. *    TR0～31が最初の４バイト、TR32～63が次の４バイトという風に合計256
  111. *    トラック分まであります。
  112. *    movem.l (An),d0-d3 のように扱うのに都合よくなっています。
  113.  
  114.  
  115. *    ■ トラックワーク
  116.  
  117. ACTIVE:        equ    $00    *.b トラックアクティビティ    -1=kill 0=active
  118.  
  119. *    ここが０でなければ演奏処理をしません。
  120.  
  121. WAITSIGNAL:    equ    $01    *.b トラック間通信        -1=wait 0=normal
  122.  
  123. *    基本的には ACTIVE と同様です。
  124.  
  125. MUTEMARK:    equ    $02    *.b 7:MUTE 6:LOCK 5:NORM 4:SE 3～0:unuse
  126.  
  127. *    ビットマップのフラグです。
  128. *    bit    7    1 = 実際にミュートしています
  129. *        6    1 = ミュートの状態がロックされています
  130. *        5    1 = 通常のミュートです
  131. *        4    1 = SE機能からミュートされています
  132. *        3～0    予約
  133.  
  134. CURCH:        equ    $03    *.b 物理ch.    0～7:OPM 10～1f:ADPCM 80～:MIDI
  135.  
  136. *    操作の対象となるデバイス番号です。
  137. *    $00～$07    OPM
  138. *    $10～$1f    ADPCM
  139. *    $80～$8f    MIDI #1
  140. *    $90～$9f    MIDI #2
  141. *        :           :
  142.  
  143. NOWPITCH:    equ    $04    *.w 現在のピッチ
  144.  
  145. *    デチューン等の静的な値が合計されたピッチです。
  146. *    内蔵音源は半音=64、MIDIはベンドレンジによる値です。
  147.  
  148. *        ・MIDI BEND の変換式
  149. *        (内蔵音源でのピッチ) = (NOWPITCH)*(BENDRANGE)/128
  150.  
  151. *        equ    $06    *.b 
  152. *    未使用、必ず０。
  153.  
  154. NOWVOLUME:    equ    $07    *.b 現在のボリューム
  155.  
  156. *    現在の値の元となるボリューム値です。
  157.  
  158. EVENT:        equ    $08    *.w 各種イベント
  159.  
  160. *    ビットマップによるイベント処理フラグです。1/0=ON/OFF です。
  161. *    bit    15    音程LFO
  162. *        14    音量LFO
  163. *        13    ポルタメント
  164. *        12～0    未定義
  165.  
  166.  
  167. PARAMCHGJOBADR:    equ    $0c    *.l パラメータ変更処理アドレス
  168.  
  169. *    各種デバイス操作ルーチンの処理アドレスが入っています。
  170. *    外部から参照しても意味がありません。
  171.  
  172.  
  173. PARAMCHG:    equ    $10    *.w パラメータ変更要求フラグ
  174.  
  175. *    外部プログラムとの通信用フラグです。
  176. *    ここは受取専用で、読み出しても大抵０が返って来ます。
  177. *    bit    15    バンク＆プログラム
  178. *        14    パンポット
  179. *        13    リバーブ
  180. *        12    コーラス
  181. *        11    ボリューム
  182. *        10～0    未定義
  183.  
  184. *    使い方は、音色切り替えを例にしますので参考にしてください。
  185.  
  186. *    (例) プログラム番号変更の手順
  187. *    1) トラックワークの BANKMSB/PROGRAM 等の内容を書き換える
  188. *    2) PARAMCHG の音色切り替えに対応したビット(15)をセットする
  189. *    -> 次の演奏処理のときにその値が実際にセットされる
  190.  
  191.  
  192. WASPITCH:    equ    $12    *.w 過去のピッチ
  193.  
  194. *    ピッチ合計です。音程LFOやポルタメント等の値が全て合計されています。
  195. *    変換式等は NOWPITCH と同じです。
  196.  
  197.  
  198. WASVOLUME:    equ    $14    *.w 過去のボリューム
  199.  
  200. *    ボリューム合計です。
  201. *    音量LFOやフェーダー等の値が全て合計されています。
  202.  
  203.  
  204. NEXTTRLINK:    equ    $16    *.w 後方へのトラックリンク
  205.  
  206. *    参照禁止です。(公開しません)
  207. *    将来変更される可能性があります。
  208.  
  209.  
  210. MMLPTR:        equ    $1c    *.l 次の命令のアドレス
  211.  
  212. *    MDCデータへのポインタです。
  213.  
  214. BANKMSB:    equ    $20    *.b 音色バンク上位
  215.  
  216. *    音色のバンクの上位の値です。
  217.  
  218. PROGRAM:    equ    $21    *.b 音色番号
  219.  
  220. *    音色番号が入っています。
  221. *    OPM は 0～255 までの値をとることができます。
  222. *    音色番号が 128 以上の場合、内部的に BANKMSB +1、
  223. *    PROGRAM -128 という処理をしています。
  224.  
  225.  
  226. VOLMST:        equ    $22    *.b ボリューム設定値
  227.  
  228. *    ボリュームの設定値です。
  229.  
  230. PANMST:        equ    $23    *.b 128段階パンポット
  231.  
  232. *    128段階のパンポット値です。
  233.  
  234. BEND:        equ    $24    *.w ベンド値
  235.  
  236. *    ベンド命令の値です。
  237.  
  238. CREVERB:    equ    $26    *.b リバーブ値
  239. CCHORUS:    equ    $27    *.b コーラス値
  240.  
  241. *    コントロールチェンジ 91:リバーブ 93:コーラス の値です。
  242.  
  243. NOWBAR:        equ    $28    *.w 現在の小節番号
  244.  
  245. *    現在の小節番号です。
  246. *    データに情報がなければ加算されません。
  247.  
  248. NOWSTEP:    equ    $2a    *.b 現在のステップ (何命令実行したか)
  249.  
  250. *    小節線から現在までに実行された命令数です。
  251.  
  252. MVOLMST:    equ    $2b    *.b マスターボリューム値
  253.  
  254. *    マスターボリューム値です。
  255. *    MIDI ではコントロールチェンジ 7:ボリューム の値です。
  256.  
  257. BANKLSB:    equ    $2c    *.b 音色バンク下位
  258.  
  259. *    音色バンクの下位バイトです。
  260.  
  261. BENDRANGE:    equ    $2d    *.b ベンドレンジ
  262.  
  263. *    ベンドレンジです。
  264.  
  265. WASPARAMCHG:    equ    $3c    *.l パラメータ変更フラグ(外部同期用)
  266.  
  267. *    パラメータが変わったことを外部に知らせるワークです。
  268. *    現在は動作していません。
  269.  
  270.  
  271.  
  272. ───────────────────────────────────────
  273.                 MIDI IN 情報取得
  274. ───────────────────────────────────────
  275.  
  276. ※搭載予定機能です。実際には存在しません。(^^;
  277.  
  278.   MCDRV では、INF_MIDIINBUF が指し示すアドレスに MIDI IN 端子から入って来た情
  279. 報を書き出す事ができます。
  280.  
  281.   アドレスは MIDI OUT に割り振られているデバイスと同じ順序で並んでいます。通常
  282. は必要ありませんが、MIDI BOARD と RS-MIDI から同時に情報を取ったりする事もでき
  283. ます。
  284.  
  285.   INF_MIDIINBUF のバッファは初期状態では内部ワークエリアに設定されていますが、
  286. 書換えて別のアドレスにする事もできます。その場合、ユーザーが新たにバッファを確
  287. 保し、諸設定を行わなければなりません。
  288.  
  289.  
  290. ・バッファは FIFO であり、構造は以下のようにします。
  291.  
  292.     offset    size    内容
  293.     +00    .w    ライトポインタ (０で初期化しておく)
  294.     +02    .w    リードポインタ (０で初期化しておく)
  295.     +06    .w    格納バッファサイズ (０で初期化しておく)
  296.     +04    .w    バッファサイズ (1～)
  297.     +08    .b    バッファ (1バイト以上)
  298.  
  299.  
  300. ・MIDI IN を有効にさせるため _MIDIINACT をコールする
  301.  
  302.   詳しくは MCCALL.DOC をお読み下さい。
  303.  
  304.  
  305. ・バッファリードサンプル
  306.  
  307. * in    d0.w    取得するデバイス番号 (0～7)
  308. * out    d0.l    正 : MIDI IN データ (0～255)
  309. *        負 : エラー
  310.  
  311. GET_MIDIIN:    movem.l    d1/a0,-(sp)
  312.  
  313.         cmpi.w    #8,d0
  314.         bcc    get_midiinerr
  315.  
  316.         movea.l    MCDRV_WORK,a0
  317.         lea    -$a0(a0),a0
  318.         lsl.w    #2,d0
  319.         movea.l    (a0,d0.w),a0
  320.  
  321.         move.w    (a0),d1            * リードポインタをとる
  322.         cmp.w    2(a0),d1        * ライトポインタと同じなら
  323.         beq    get_midiinerr        * データなし
  324.  
  325.         moveq.l    #0,d0
  326.         move.b    8(a0,d1.w),d0        * データ取得
  327.  
  328.         addq.w    #1,d1            * ポインタを進める
  329.         cmp.w    4(a0),d1        * バッファサイズ以上なら
  330.         bcs    get_midiin10
  331.         moveq.l    #0,d1            * ポインタを先頭に
  332. get_midiin10:    move.w    d1,(a0)
  333.  
  334. get_midiin90:    movem.l    (sp)+,d1/a0
  335.         rts
  336.  
  337. get_midiinerr:    moveq.l    #-1,d0
  338.         bra    get_midiin90
  339.  
  340. MCDRV_WORK:    ds.l    1    * MCDRV のワークアドレスをセットしておく
  341.  
  342.  
  343.  
  344. ───────────────────────────────────────
  345.             ノートオン/オフ情報取得
  346. ───────────────────────────────────────
  347.  
  348.   MCDRV からのノートオン情報は、ノートオン等を出力する専用のバッファがあります
  349. ので、これを利用します。バッファアドレス取得には _GETKEYONPTR を使用します。
  350.  
  351. ■ ノートオンバッファの構造
  352.  
  353. MCNONPTR:    ds.w    1        * FIFO の最新ポインタ
  354. MCNONBUF:    ds.b    4*256        * ノートオン情報
  355.  
  356.  
  357. ■ MCNONBUFの構造
  358.  
  359. _N_TRACK:    ds.b    1    *+00    トラック
  360.     どのトラックからの情報かを表わします。
  361.  
  362. _N_NOTE:    ds.b    1    *+01    ノート番号
  363.     どの音階がノートオンされたかを表わします。
  364.  
  365. _N_VELO:    ds.b    1    *+02    ベロシティ
  366.     ベロシティが０だった場合、ノートオフしたことを表わします。
  367.  
  368. _N_CH:        ds.b    1    *+03    チャンネル
  369.     v0.60 より有効です。どのチャンネルでノートオンされたかを表わします。
  370.  
  371.  
  372. ■ 実際の情報取得
  373.  
  374.   各プログラムで過去の MCNONPTR を持っておいて下さい。
  375.  
  376.   ここではそれを仮に MYNONPTR とします。
  377.  
  378. getnoteon:
  379.     move.w    MCNONPTR(a5),d0        * a5=MCDRVのワークのアドレス
  380.     cmp.w    MYNONPTR,d0        * ポインタが進んでないか
  381.     beq    getnoteonend
  382.  
  383.     addq.w    #4,d0            * 進んでいた時の処理
  384.     andi.w    #$3ff,d0
  385.     move.w    d0,MYNONPTR        * 自分のポインタを進める
  386.  
  387.     lea    MCNONBUF(a5),a0
  388.     adda.w    d0,a0
  389.     move.b    (a0)+,d1        * トラック
  390.     move.b    (a0)+,d2        * ノート
  391.     move.b    (a0)+,d3        * ベロシティ
  392.         :            * 必要に応じた処理
  393.     bra    getnoteon        * 繰り返す
  394.  
  395. getnoteonend:                * 終了
  396.  
  397.  
  398.   こんな感じで行なって下さい。
  399.  
  400.   (無駄は各プログラムでいいように調整して下さい)
  401.  
  402.  
  403.  
  404. ───────────────────────────────────────
  405.                 演奏同期
  406. ───────────────────────────────────────
  407.  
  408.   演奏開始からの経過クロックがシステムワークの INF_NOWCLOCK に格納されています。
  409. 同期にはこの数値を見て特定の値を超えたら処理をする様な事を行なって下さい。
  410.  
  411. ■ 実際の演奏同期例
  412.  
  413. loop:    MCDRV    _GETNOWCLOCK
  414.     cmpi.l    #同期させたいクロック,d0
  415.     bcs    loop
  416.  
  417.  
  418. ───────────────────────────────────────
  419.             メモリ管理テーブルの構造
  420. ───────────────────────────────────────
  421.  
  422.   MCDRV のメモリ管理ポインタの構造です。
  423.  
  424.     ofst    説明
  425.  
  426.     +00    一つ前のメモリ管理ポインタのアドレスが入っています。
  427.  
  428.     +04    次の            〃
  429.  
  430.     +08    このメモリブロックのサイズが入っています。
  431.         メモリ管理ポインタのサイズ 16 byte は含まれていません。
  432.  
  433.     +0c    00    削除/リムーブ等が可能です。
  434.         01    このメモリブロックは MCDRV によってロックされています。
  435.         80        〃        外部からロックされています。
  436.  
  437.     +0d    00    空です。
  438.         01    MDCデータが入っています。
  439.         02    ADPCMデータが入っています。
  440.         80    外部から確保された作業用ブロックです。
  441.  
  442.     +0e    拡張用です
  443.     +0d
  444.  
  445.     +10    データはここから入っています。
  446.  
  447.   ユーザーが直接この値を見ることはほとんど無いと思います。
  448.  
  449.  
  450. ───────────────────────────────────────
  451.                  効果音等について
  452. ───────────────────────────────────────
  453.  
  454.   MCDRV は元々ゲーム組み込み用に作られたドライバーなので、効果音機能の扱い方も
  455. 比較的簡単に作られています。
  456.  
  457. ■ MDC データによる効果音
  458.  
  459. ・効果音制御の仕組
  460.  
  461.   効果音トラックはドライバ内の未使用トラックの内、後方から使用されていきます。
  462. ですから、起動時の -t オプションで確保したトラック本数以上の効果音の演奏はでき
  463. ません。
  464.  
  465.   上の様に処理されるため、トラック同期コマンド (MXDRV の W,S に相当) は使用で
  466. きません。
  467.  
  468.   また、OPM のハード LFO やホワイトノイズなどはドライバ側では一切管理していま
  469. せん。従って、実用上メインか効果音の演奏のどちらか一方でしか使用する事ができま
  470. せん。大抵の場合、効果音側でしか使用しないと思いますので、メイン演奏側ではこれ
  471. らは使用しないようにします。
  472.  
  473.   効果音演奏中にさらに重ねて効果音を演奏させる事ができます。通常は効果音は後発
  474. 優先で、最優先で演奏させたい場合は _PLAYSE2 を使用するようします。この場合、あ
  475. る程度のレベルの割付をしてやる必要があります。
  476.  
  477.   内蔵 FM 音源の音色管理はドライバ内部で独立して行うので、他の曲に同じ番号で違
  478. う音色が登録してあっても正常な演奏ができます。
  479.  
  480.   テンポの管理は効果音全体で１つしかありません。効果音を多重に呼び出す場合には、
  481. 効果音のテンポをなるべく一定にして作るよう心掛けて下さい。
  482.  
  483.  
  484. ・実際の操作等
  485.  
  486.   ごく普通に演奏データを作ります。あとはメモリ上に固定しておき、_SEPLAY を実行
  487. すればいつでも効果音として慣らす事ができます。
  488.  
  489.   FADELVL を０にすると全トラックがマスクされた様な状態になります。これを利用す
  490. ればメイン演奏とサブ演奏をスムーズに切り替えるといった芸当が可能です。
  491.  
  492.  
  493.